home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / oview.z / oview
Encoding:
Text File  |  2002-10-03  |  8.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. OOOOVVVVIIIIEEEEWWWW((((1111))))                                                              OOOOVVVVIIIIEEEEWWWW((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      oooovvvviiiieeeewwww - visualize the performance of an Origin server
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      oooovvvviiiieeeewwww [-_V_w] [pmview+ options | oview4sn0 options]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      oooovvvviiiieeeewwww displays the topology of an Origin server with performance
  16.      information about CPUs, nodes and routers. The display is updated with
  17.      new values retrieved from the target _h_o_s_t or _a_r_c_h_i_v_e every _i_n_t_e_r_v_a_l
  18.      seconds (default is 2 seconds).
  19.  
  20.      oooovvvviiiieeeewwww behaves differently and produces different views for SGI 3000 and
  21.      SGI 2000 systems. For SGI 3000 systems oooovvvviiiieeeewwww constructs the view
  22.      configuration and launches ppppmmmmvvvviiiieeeewwww++++.... In the SGI 2000 case oooovvvviiiieeeewwww parses the
  23.      command line and launches oooovvvviiiieeeewwww4444ssssnnnn0000....
  24.  
  25.      The rest of this document discusses the the first case, i.e displaying
  26.      information about SGI 3000 systems. See oooovvvviiiieeeewwww4444ssssnnnn0000(1) for details about
  27.      displaying data from SGI 2000 systems.
  28.  
  29.      oooovvvviiiieeeewwww generates a ppppmmmmvvvviiiieeeewwww++++(1) configuration file, and passes most command
  30.      line options to ppppmmmmvvvviiiieeeewwww++++(1).  Therefore, the command line options ----AAAA, ----aaaa,
  31.      ----CCCC, ----hhhh, ----nnnn, ----OOOO, ----pppp, ----SSSS, ----tttt, ----TTTT, ----ZZZZ and ----zzzz, the _X_1_1-_a_r_g_s and user
  32.      interface are described in the ppppmmmmvvvviiiieeeewwww++++(1) man page.
  33.  
  34.      oooovvvviiiieeeewwww can display the topology of SGI 3000 systems with up to eight
  35.      routers, which covers systems with 1 to 128 CPUs. Configurations with
  36.      metarouters and repeater routers are currently not supported.
  37.  
  38. CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS
  39.      There are two oooovvvviiiieeeewwww specific options.  If ----VVVV is present, the
  40.      configuration file is printed on the standard output and ppppmmmmvvvviiiieeeewwww++++ is nnnnooootttt
  41.      executed.  If ----wwww is present and an SGI 3000 system is being monitored,
  42.      then the ``wait'' time is included for each processor (the default is to
  43.      display only the ``user'' and ``system'' components of the CPU time).
  44.      All other options are passed either to ppppmmmmvvvviiiieeeewwww++++(1) or to oooovvvviiiieeeewwww4444ssssnnnn0000(1).
  45.  
  46. VVVVIIIISSSSUUUUAAAALLLLIIIIZZZZAAAATTTTIIIIOOOONNNN
  47.      Routers are represented by oblong boxes with a colored indicator of the
  48.      router's utilization on the top of the box. The color of the indicator
  49.      has the following meaning:
  50.  
  51.      ccccyyyyaaaannnn insignificant router utilization
  52.           0 <= utilization < 1%
  53.  
  54.      lllliiiigggghhhhtttt ccccyyyyaaaannnn
  55.           light router utilization
  56.           1% <= utilization < 5%
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. OOOOVVVVIIIIEEEEWWWW((((1111))))                                                              OOOOVVVVIIIIEEEEWWWW((((1111))))
  71.  
  72.  
  73.  
  74.      yyyyeeeelllllllloooowwww
  75.           medium router utilization
  76.           5% <= utilization < 20%
  77.  
  78.      oooorrrraaaannnnggggeeee
  79.           high router utilization
  80.           20% <= utilization < 40%
  81.  
  82.      rrrreeeedddd  saturated router utilization
  83.           utilization >= 40%
  84.  
  85.      Nodes are represented by square boxes and CPUs are represented by a
  86.      stacks of bbbblllluuuueeee, rrrreeeedddd and ccccyyyyaaaannnn colored blocks to show the uuuusssseeeerrrr, ssssyyyysssstttteeeemmmm and
  87.      wwwwaaaaiiiitttt (if ----wwww specified) utilization of each CPU, respectively. The CPU
  88.      stacks are grouped to appear on the top of the node they are physically
  89.      connected to.
  90.  
  91.      Router ports are represented by cylindrical stacks, connected to the
  92.      sides of a router box. The topology of the connection depends on the
  93.      configuration of a machine. The router port stack shows the rrrreeeecccceeeeiiiivvvveeee
  94.      bbbbyyyyppppaaaassssssss and the rrrreeeecccceeeeiiiivvvveeee qqqquuuueeeeuuuueeeedddd utilization on the per-port basis as vvvviiiioooolllleeeetttt
  95.      and yyyyeeeelllllllloooowwww bands, respectively, which grow away from the router box as
  96.      utilization increase.  A grey cylinder adjacent to the colored bands, if
  97.      visible, represents the unused bandwidth capacity.
  98.  
  99.      Unanimated ``pipes'' are used to join the endpoints for each router
  100.      connection.
  101.  
  102.      To avoid cluttering the scene, especially for large configuration, CPUs
  103.      and nodes may be omitted from the view. The ----llll option can be used to
  104.      select the ``level of details'' as follows:
  105.  
  106.  
  107.          0000    Show only routers.
  108.  
  109.          1111    Show routers and nodes.
  110.  
  111.          2222    Show all the routers, nodes and CPUs. This is the default.
  112.  
  113.  
  114. FFFFIIIILLLLEEEESSSS
  115.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....oooovvvviiiieeeewwww
  116.                A ppppmmmmllllooooggggggggeeeerrrr(1) configuration file for oooovvvviiiieeeewwww metrics.
  117.  
  118. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  119.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  120.      file and directory names used by PCP.  On each installation, the file
  121.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  122.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  123.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. OOOOVVVVIIIIEEEEWWWW((((1111))))                                                              OOOOVVVVIIIIEEEEWWWW((((1111))))
  137.  
  138.  
  139.  
  140. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.      oooovvvviiiieeeewwww4444ssssnnnn0000(1), ppppmmmmccccdddd(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmllllooooggggggggeeeerrrr(1), ppppmmmmttttiiiimmmmeeee(1) and ppppmmmmvvvviiiieeeewwww++++(1).
  142.  
  143. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  144.      The algorithm for 3-D layout of SGI 3000 system components by oooovvvviiiieeeewwww is
  145.      complex, and relies on heuristics.  If you encounter a configuration that
  146.      is not displayed as expected, please send e-mail to ppppccccpppp----iiiinnnnffffoooo@@@@ssssggggiiii....ccccoooommmm
  147.      including a description of the problem, and attaching the output from
  148.  
  149.                pminfo -f hinv
  150.  
  151.      There are may be problems when oooovvvviiiieeeewwww cannot guess the information about
  152.      routers connectivity in the non-standard SGI 3000 configuration. In this
  153.      case router ports would be displayed but no attempt is made to draw the
  154.      links between them.
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.